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DESCRIPTION 
The Mail System is 4 program that allows messages to be 
createc, sent, received, and filed using tne Ciuster,/Ore 
Model A network. > É 


Organization | ge 

There are two kinds of files manipulated by the,mail system. 
The first kind is for mew mail; each piece of mail thet has 
beer gent to you is created es efile, under your main 
directory in the subdirectory NEWMAIL, wHich can be thought 
of as &@ queue for incoming messages. The’second kind of file 
is a (lerge) repository for meil that you have received and 
saved for future reference. You may enter new pieces of 
mail into this repository, classify them in categories that 
you invent, and manipulate them in severel ways. This 
repository is a file called MAIL im your directory, end will 
be created the first time you execute MAIL. 


Mailed messages corsist of two parts: the heeder wend the 
body. The header contains some or all of the following 
keyword fields: | s 


HEO: Who the mail went to directly * . 
CC: Who else received copies ( ommpe 221) 
FROM: Who it came from 
. DATE: When it was sent or forwarded 
b go UES BEES A short description of the contents (optional) 


Thei body consists of text lines. There is ro limit on the 
size of the body, but for several reasons you are encouraged 
to send pointers to lerge files rather than the files 
themselves. J e 

ae 
Each piece of mail which has been saved in your mail file 
can be assigned to one or more mail classes. A mail class 
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is simply a name you pick to characterize a class of 
messages; you can then use thet name in commands to the mail 
system. There can be up to 28 classes, and each message can 
belong to any set of clesses. A new class name is created 
when the first message is put into that cless. 


OPERATING INSTRUCTIONS 


eee ae ee — oe Oe ee ee ee l a e 


You can run it in two ways: 


1) Directly, by X 
pascal:mail 


2) Automatically when you logon, by 


(a) putting a copy of PASCAL:SYSTEM.STARTUP 
on your disk, and 
(b) including the line MAIL 
or the line MAIL xxx 


(where xxx are your initials) in your STARTUP.TEXT file. 
The second form will eliminate the reed for the mail 
system to ask who you are, and will also autometically 
read your new mail by supplying READ (q.v.) as the first 
command. 


All input can be in upper or lower case and is termineted 
with RETURN. The sequence ESC RETURN will abort the meil 
program. If you are unsure about how to respond to any 
prompt, type ? RETURN and you will get @ ore or two line 
hint. If a long piece of mail is being typed and you are 
impatient to get it over with, type TC (cortrol-C). 


Command operands ere generally optional, and required 
information that you omit will be asked for. 


There are several places where you will be promptec with a 
suggested reponse, like: 





To: FDR? 


If you like the suggestion, just type RETURN. If you type 
anything else, your input will be used instead. To cancel 
the suggestion but not supply anything, type a blank 
followed by RETURN. i 
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Commands 


ee ee ee oe 


Command: READ 


This is the command to check for incoming messages. You are 
told how many new pieces of mail you have, end for each ore 
you are given the opportunity to read it or leave it in the 
input queue to be read later. Mail is identified by sender, 
date, and an optiornel sequence number. 


As new pieces of mail are read and listed, you car choose to 
do any or all of the following: 


(1) Answer the mail, that is, send a message back to 
whomever sent you the mail. 


(2) Forward the mail to someone else. You provide an 
optional preface which is sent first, followed by the 
entire piece of mail with an indication that it is 
forwarded mail. 


CA 
~~ 


Save the mail in your mail file. You car assigr it to 
one or more classes. 


~~ 
> 
~— 


List it egain 


~ 
n 


) Go on to the next piece of new mail. If you heve 
saved this mail then it will be deleted from the new 
mail queue automatically, otherwise you will be asked 
if you want it deleted. New mail which is not celeted 
will be there the next time you use the READ command. 


(6) Quit, that is, stop reading new mail. Unread meil 
will still be there next time. Fress RETURN to exit 
from the READ command. 


— = e ee 


This allows you to send mail to one or more people. You are 
prompted for a list of people’s initials, the current date, 
én optional subject, an optional carbon-copy list, ard the 
body of the message. The body can be typed directly 
(terminated with CTRL-D RETURN) or can come in part or in 
whole from a previously created file by séeying Z#filereme. 


6/28/80 z 


MAIL 


As the mail is sent to each person in the TO or CC list, you 
cen elect to register that copy of the mail, which 
requests that a return receipt be sent back when the mail is 
read. The recipient is told that the mail is registered, 
and can allow the receipt to be sent or serd a rejection 
instead, in which case ke does not get to read the mèil. 


There is currently ro check made to see thet the person to 
whom you are sending mail actually exists. Ee sure to use 
the correct user initials, otherwise the mail will be sert 
but never received. 


After the mail has been sent to everyone in the list, you 
will be asked if you want to save a blind copy in your 
mail file. If you do, you can assign it to any number of 
classes. 


This allows you to resend mail which has been saved ir your 
Mail file. You may change only the TO header to redirect 
the meil; all other parts ere sent unchanged. This is 
useful if you left someone off the TO list of ae previous 
mailing. 


These allow you to forwerd or answer a saved message in much 
the same way as you can forward or answer incoming méil at 
the time you reed it. 


Command: LIST <msgseq> 


ee ee ee ee — 


This lists some or all of the messages seveå in your MAIL 
file. The header and the body of each messege is listed. 


This lists only information from the header of some or àll 
of the messages in your MAIL file. 


Only one line is printed for each message. It shows the 
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messege number, the person who sent the mail (if you 
received it) or the person who received the meil (if you 
sent it), the date, and the subject. 


— ee ee oe — a — ee 


This deletes messages in your mail file. If you do not READ 
any new mail deleted messages can be recovered, but only 
with much grief, hex dumping, and gnashing of teeth. 


This allows you to add one or more saved messeges to 4 
particular class. The class will be created if it doesnt 
already exist. 


Command: DECLASSIFY <msgseq>,<classname> 


—_—— Å — ee ee ee ee ee Å — oe l e ee 


This allows you to remove one or more saved messages from a 
class that they belorg to. 


— e e ee ee ee — a — a e e e ee — ee ——_—— _— oe ee ee ee 


This allows you to change the name of a class. All messeges 
which belonged to the old class will belong to the new claéss 
instead. 


This writes one or more messages from your MAIL file to a 
Pascal.TEXT file that you specify. This. is useful for 
printing messages, for exemple. 
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This gives a summary of whet hes changed in the mail system 
since the last release. You will get a recommendation to 
use the NEWS command the first time you use each new version 
of the MAIL program. 


Command: SHOW CLASSES 


— = oe e ee ee MM eed — a Oe ee ee ee ee 


Lists &ll the class names into which messages have been 


This sends <string> to the file server as a command. Any 
error response is printed. This is included primarily for 
issuing MOUNT commends to mount virtual disks whick will be 
used by the mail system. 


Command: QUIT or Q 


a — — ee — 


Exits the MAIL program. 


<msgseq> 


This is the specification of some subset of the mail in your 
MAIL file. The syntax is: 


<msgseq> ::= ALL All the messeges in MAIL 
<expre A single messege, by number 
<exprid:<expr2> Message Lumber <expr1> to 
<expre>, inclusive 
<exprid!<expr2> <expr2> messages starting 


with messege number <expri> 
@<clessreme> [IN <msgseq>] 

All messages in <msgseq> 

which are also in the 

class <classneme>. IN ALL 

assumed if it is omitted. 


<expr> :3= <number> A specific message number 
L The lest message 
F The first message 
The current message 
N The next message (.+1) 


8/28/82 £ 


MAIL 


P The previous message (.-1) 
<expro>t+<expr> Arithmetic useful for 
Cex pro>-<expr> things like .+2 or L-i 


ti 


<classname> : <é 1-15 character name> 


<number> s:= <an integer> 


MAIL uses virtual drives 11 (for your MAIL file) and 12 (for 
the new meil), so anything you have mounted there will be 
implicitly unmounted. It also assumes thet D11 end D12 are 
virtuel and therefore it won’t work if you heve a real disk 
controller in slot 5. (You can use the SET command in your 
STARTCMD file to temporarily virtualize 11 and 12 while 
executing MAIL). Needs fixed, as they say in Pittsburgh. 


My current TODO list includes: 


) A better scheme for generating NEWMAIL names 
) A way to check if an addressee exists (see if there is 
a NEWMAIL directory? A MAIL file? A global list? 

(c) Possibly making message numbers sticky insteed of 
consecutive 

(d) A public mailbox mechanism to use for bulletin boards. 
Keep last item read” info in the MAIL file. 

(e) Allowing 4file in other places (for example in TO, to 
allow distribution list files) 

(£) A “soft” escape to abort a subcommand such as SEND. 


Other suggestions are welcome. 
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